home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor1 / transapp.doc < prev    next >
Text File  |  1995-03-31  |  3KB  |  64 lines
  1. Program Development Link Translator 
  2. Author: Ted Beers 
  3. Date: Mon Mar 04 1991 
  4.  
  5. We (the developers of PDL) considered building into PDL the automatic 
  6. conversion of HP 48 "directory-format" files into PDL format, but were 
  7. eventually stymied by the free-form manner in which the HP 48 transfers 
  8. directory objects.  We concluded that, to properly translate from HP 48 
  9. directory format, PDL would have to be able to parse HP 48 user language--a 
  10. task we avoided for the sake of releasing PDL as soon as possible. 
  11.  
  12. (By the way, PDL is at least benevolent towards the HP 48 ASCII transfer 
  13. format; you can open a file transferred from the HP 48 [provided it's not too 
  14. large] and PDL will interpret the angle and fraction mark modes and use the 
  15. contents of the file as a single unnamed variable.) 
  16.  
  17. Anyway, we also investigated the concept of a format conversion utility that 
  18. allowed the user to interactively "parse" his own work and that simplified the 
  19. file editing aspect of the task.  This utility was abandoned as part of the PDL 
  20. package because of resource and scheduling difficulties. 
  21.  
  22. Since PDL is finally finished, however, we've had a chance to take another look 
  23. at the format conversion utility.  So here it is (in uuencode format and 
  24. offered "as is"), along with more information. 
  25.  
  26.     Ted Beers 
  27.     Software R&D Engineer 
  28.     Hewlett-Packard 
  29.  
  30.  
  31. The MS-DOS program called TransApp can be used to translate an HP 48 
  32. application file on your PC from most ASCII formats to the PDL application file 
  33. format. 
  34.  
  35. An HP 48 application not developed in PDL usually has one of these formats: 
  36.  
  37.       o HP 48 directory format.  Contains one "flat" directory object 
  38.         representing the complete application. 
  39.  
  40.       o Packed format.  Contains objects, names, and commands for 
  41.         creating the application using the HP 48 stack. 
  42.  
  43. For each of these formats, the file may contain a "%%HP" header line defining 
  44. HP 48 settings.  Here is an example comparing directory format, packed format, 
  45. and standard "PDL format": 
  46.  
  47.       Directory Format       Packed Format           PDL Format 
  48.   
  49.       %%HP:...;              %%HP:...; 
  50.       DIR                    'name-1'                ... 
  51.         name-1               obj-1                   /Var name-1 
  52.         obj-1                SWAP STO                obj-1 
  53.         name-2               'name-2'                /Var name-2 
  54.         obj-2                obj-2                   obj-2 
  55.         ...                  SWAP STO                ... 
  56.         name-n               ...                     /Var name-n 
  57.         obj-n                'name-n'                obj-n 
  58.       END                    obj-n 
  59.                              SWAP STO 
  60.   
  61. [Note: the source file MUST NOT end with ^Z (ASCII 26, the CTRL-Z code), or 
  62.  TRANSAPP will bomb out.  If necessary, remove the DOS end-of-file marker 
  63.  manually with your favorite text editor.  -jkh-] 
  64.